Track transaction by reference

curl --request GET \
  --url https://api.dev.monei.cc/api/v1/offramp/ledger/status/{reference} \
  --header 'X-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://api.dev.monei.cc/api/v1/offramp/ledger/status/{reference}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.dev.monei.cc/api/v1/offramp/ledger/status/{reference}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.dev.monei.cc/api/v1/offramp/ledger/status/{reference}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-KEY", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.dev.monei.cc/api/v1/offramp/ledger/status/{reference}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "internalReference": "OFF-A1B2C3D4",
  "provider": "monirates",
  "providerTransactionId": "68ee3a94c05777e37c10b3c1",
  "status": "processing",
  "cryptoAmount": 100,
  "fiatAmount": 145800,
  "exchangeRate": 1458,
  "fromCurrency": "USDT",
  "toCurrency": "NGN",
  "createdAt": "2025-10-14T11:57:08.122Z",
  "updatedAt": "2025-10-14T11:57:09.065Z",
  "expiresAt": "2025-10-14T12:27:08.122Z",
  "providerStatus": "PROCESSING",
  "fees": {
    "providerFee": 0.01,
    "networkFee": 0.0015,
    "serviceFee": 0.005
  },
  "debitPaymentDetails": {
    "paymentMethod": "STABLE_CURRENCY",
    "currency": "USDT",
    "network": "BEP20",
    "walletAddress": "0x5860a46314c08be9fdFBE7fF3ce9604dC59551D1"
  },
  "creditPaymentDetails": {
    "paymentMethod": "BANK_TRANSFER",
    "currency": "NGN",
    "accountName": "John Doe",
    "accountNumber": "0115847370",
    "bankCode": "999240"
  },
  "completedAt": "2025-10-14T12:00:00.000Z"
}

GET

api

offramp

ledger

status

{reference}

Track transaction by reference

curl --request GET \
  --url https://api.dev.monei.cc/api/v1/offramp/ledger/status/{reference} \
  --header 'X-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://api.dev.monei.cc/api/v1/offramp/ledger/status/{reference}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.dev.monei.cc/api/v1/offramp/ledger/status/{reference}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.dev.monei.cc/api/v1/offramp/ledger/status/{reference}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-KEY", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.dev.monei.cc/api/v1/offramp/ledger/status/{reference}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "internalReference": "OFF-A1B2C3D4",
  "provider": "monirates",
  "providerTransactionId": "68ee3a94c05777e37c10b3c1",
  "status": "processing",
  "cryptoAmount": 100,
  "fiatAmount": 145800,
  "exchangeRate": 1458,
  "fromCurrency": "USDT",
  "toCurrency": "NGN",
  "createdAt": "2025-10-14T11:57:08.122Z",
  "updatedAt": "2025-10-14T11:57:09.065Z",
  "expiresAt": "2025-10-14T12:27:08.122Z",
  "providerStatus": "PROCESSING",
  "fees": {
    "providerFee": 0.01,
    "networkFee": 0.0015,
    "serviceFee": 0.005
  },
  "debitPaymentDetails": {
    "paymentMethod": "STABLE_CURRENCY",
    "currency": "USDT",
    "network": "BEP20",
    "walletAddress": "0x5860a46314c08be9fdFBE7fF3ce9604dC59551D1"
  },
  "creditPaymentDetails": {
    "paymentMethod": "BANK_TRANSFER",
    "currency": "NGN",
    "accountName": "John Doe",
    "accountNumber": "0115847370",
    "bankCode": "999240"
  },
  "completedAt": "2025-10-14T12:00:00.000Z"
}

Authorizations

X-API-KEY

string

header

required

Path Parameters

reference

string

required

Example:

"OFF-A1B2C"

Response

200 - application/json

string

required

Transaction ID

Example:

"123e4567-e89b-12d3-a456-426614174000"

internalReference

string

required

Internal reference number

Example:

"OFF-A1B2C3D4"

provider

enum<string>

required

Exchange provider

Available options:

monirates,

bitnob,

paycrest

Example:

"monirates"

providerTransactionId

string

required

Provider transaction ID

Example:

"68ee3a94c05777e37c10b3c1"

status

enum<string>

required

Current transaction status

Available options:

initiated,

quote_created,

awaiting_deposit,

deposit_received,

pending,

processing,

fiat_sent,

completed,

failed,

cancelled,

refunded

Example:

"processing"

cryptoAmount

number

required

Cryptocurrency amount

Example:

100

fiatAmount

number

required

Fiat currency amount

Example:

145800

exchangeRate

number

required

Exchange rate applied

Example:

1458

fromCurrency

string

required

From currency

Example:

"USDT"

toCurrency

string

required

To currency

Example:

"NGN"

createdAt

string<date-time>

required

Transaction creation timestamp

Example:

"2025-10-14T11:57:08.122Z"

updatedAt

string<date-time>

required

Transaction last update timestamp

Example:

"2025-10-14T11:57:09.065Z"

expiresAt

string<date-time>

required

Transaction expiry timestamp

Example:

"2025-10-14T12:27:08.122Z"

providerStatus

string

required

Provider status

Example:

"PROCESSING"

fees

object

required

Transaction fees

Example:

{
  "providerFee": 0.01,
  "networkFee": 0.0015,
  "serviceFee": 0.005
}

debitPaymentDetails

object

required

Debit payment details

Example:

{
  "paymentMethod": "STABLE_CURRENCY",
  "currency": "USDT",
  "network": "BEP20",
  "walletAddress": "0x5860a46314c08be9fdFBE7fF3ce9604dC59551D1"
}

creditPaymentDetails

object

required

Credit payment details

Example:

{
  "paymentMethod": "BANK_TRANSFER",
  "currency": "NGN",
  "accountName": "John Doe",
  "accountNumber": "0115847370",
  "bankCode": "999240"
}

completedAt

string<date-time> | null

required

Transaction completion timestamp

Example:

"2025-10-14T12:00:00.000Z"

Get transaction history